home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 351-375 / disk_359 / textplus / english / txp2.0e.doc < prev    next >
Text File  |  1992-05-06  |  12KB  |  360 lines
  1. *****************************************************************************
  2. *                                                                           *
  3. *             Text Plus V2.0 (c) Copyright 1990 by Martin Steppler          *
  4. *                                                                           *
  5. *  Text Plus V2.0 is SHAREWARE. It is freely redistributable, although all  *
  6. *  rights remain with the author. If you like Text Plus and use  it  regu-  *
  7. *  larly,  you should send me a donation ($15). This will make you get not  *
  8. *  only the latest update, but also the sourcecode.                         *
  9. *  Advice for all PD-distributors:                                          *
  10. *  Text Plus V2.0 must not be added to a PD-library without my consent. The *
  11. *  price must not exceed the costs of disk, package and mailing.            *
  12. *                                                                           *
  13. *  Please send bug-reports, suggestions, comments, and MONEY (!!!) to:      *
  14. *                                                                           *
  15. *                              Martin Steppler                              *
  16. *                           Dr.-Danzebrink-Str. 11                          *
  17. *                     D-6400 Fulda, Fed. Rep. of Germany                    *
  18. *                                                                           *
  19. *****************************************************************************
  20.  
  21.  
  22. CREDITS
  23.  
  24. First  I  want to thank JONATHAN POTTER, whose FileRequester (Fish #242) I've
  25. used. He wrote the best and most comfortable filerequester, I've seen so far.
  26. Thanks Jonathan!
  27.  
  28.  
  29. CONTENTS
  30.  
  31. I     INSTALLATION
  32.  
  33.       Descrption of menus and their points:
  34.  
  35. II    PROJECT
  36. III   EDIT
  37. IV    PREFS
  38. V     STYLE
  39. VI    FIND
  40.  
  41. VII   KEYMAP AND SHORTCUTS
  42.  
  43.  
  44.                                I) INSTALLATION
  45.  
  46.  
  47. Text Plus V2.0 (from now on refered to as TP) can be run from both, workbench
  48. and CLI. Starting from CLI allows you to send a filename to  TP,  which  will
  49. be automatically loaded.
  50.  
  51. Example: Text_Plus_V2.0 df0:example_file.txp
  52.  
  53. If  the  start  was successful, TP tries to load its configuration-file 'TxP.
  54. Config', and if TP fails to find it in the current directory, TP will  search
  55. for  it  in  the  's:'-directory.  The configuration-file enables the user to
  56. create a personal environment according to  his  own  requirements,  i.e.  to
  57. preset  the  text-width, page-length, tabulators etc. TxP.Config is an ASCII-
  58. file, which can be changed very easily. This is why I think  the  remarks  in
  59. TxP.Config  fully  suffice  for  understanding,  how  to change the settings.
  60. Anyway, TP runs without TxP.Config, too.
  61.  
  62.  
  63.                                  II) PROJECT
  64.  
  65.  
  66. 1) LOAD
  67.  
  68. After  clicking  on  this  menu-point  a  filerequester  pops up, the current
  69. function of which - here: 'Load file' - is displayed in the window-title-bar.
  70. The  file  requester  presents a very easy way to access any file anywhere on
  71. the Amiga. It consists of several different gadgets :
  72.  
  73.    -  Directory gadgets which allow you to select a file, drawer or volume
  74.       by scrolling through a list and clicking on the one you want, or by
  75.       entering your own in a string gadget.
  76.  
  77.    -  PARENT gadget allows you to jump back to the parent of the current
  78.       directory.
  79.  
  80.    -  OKAY gadget which you use to end the requester and accept your
  81.       choices. An alternative to this is double clicking on a file name.
  82.  
  83.    -  CANCEL gadget which you use to end the requester and reject your
  84.       choices.
  85.  
  86.    -  RENAME gadget which allows you to rename the currently selected
  87.       file.
  88.  
  89.    -  DELETE gadget which allows you to delete the currently selected
  90.       file.
  91.  
  92.    -  MAKE DIR gadget which allows you to make a subdirectory in the
  93.       current directory.
  94.  
  95. To scroll through the lists of files, drawers and volumes you have  a  slider
  96. which  lets  you  scan quickly through the entries, and an up and down gadget
  97. which allows you to move through the list one  entry  at  a  time.  When  the
  98. requester  is  first  opened,  the available volumes are read in, sorted, and
  99. added to the list. The current directory  is  then  searched  for  files  and
  100. subdirectories,  which  are  then  sorted.  All  gadgets are active while the
  101. directories are being read/sorted. The volume list is only  updated  on  disk
  102. changes,  however  the  file and drawer lists are updates whenever you change
  103. directory (or choose a new volume).
  104.  
  105. After a file has been chosen as described above, TP to loads either an ASCII-
  106. file (letter-mode switched off) or a letter (letter-mode switched on;  suffix
  107. '.txp').
  108.  
  109. 2) APPEND FILE
  110.  
  111. A file will be appended to the end of the already existing file.
  112.  
  113. 3) DELETE FILE
  114.  
  115. The file will be deleted in memory.
  116.  
  117. 4) SAVE
  118.  
  119. The file is saved with its current name depending on the letter-mode either
  120. in letter-format or as an ASCII-file. The filerequester won't pop up.
  121.  
  122. 5) SAVE AS ...
  123.  
  124. After  a  filename  has been chosen, it is saved depending on the letter-mode
  125. either in letter-format or as an ASCII-file.
  126.  
  127. 6) SAVE & QUIT
  128.  
  129. The file is saved with its current name and then you leave TP.
  130.  
  131. 7) PRINT
  132.  
  133. A requester appears, in which you can choose one of  four  print-modes  (NLQ,
  134. Pica,  Elite  or  Condensed)  and set the pages to be printed, left and right
  135. margin, and the paper-length. Furthermore you can  switch  on/off  the  page-
  136. numbering-mode  (at  the  end  of every page its number is printed) and the
  137. line-numbering-mode.
  138. At the beginning of every page the user is asked, whether he  wants  to  skip
  139. over  the  respective  page,  print  it or abort. If an error occurs, you are
  140. requested, whether you want to  try again or abort.
  141.  
  142. 8) HELP
  143.  
  144. Show the keymap.
  145.  
  146. 9) ABOUT
  147.  
  148. Informations about the author.
  149.  
  150. 10) QUIT
  151.  
  152. Quit TP without saving changes.
  153.  
  154.  
  155.                                   III) EDIT
  156.  
  157. 1) MARK BLOCK
  158.  
  159. The current position of the cursor determines the beginning and after another
  160. click  on MARK BLOCK the end of the block. Now the block-mode is switched on,
  161. which can only be switched off  by  clicking  on  'Delete  Mark'  or  'Delete
  162. Block'.  When switched on only block-operations can be carried out, i. e. new
  163. text cannot be entered.
  164.  
  165. 2) COPY BLOCK
  166.  
  167. Insert previously defined block at the current position of the cursor.
  168.  
  169. 3) DELETE BLOCK
  170.  
  171. The marked block is deleted.
  172.  
  173. 4) DELETE MARK
  174.  
  175. The block-mode is switched off.
  176.  
  177. 5) LOAD BLOCK
  178.  
  179. An previously selected file is  inserted  at  the  current  position  of  the
  180. cursor.
  181.  
  182. 6) SAVE BLOCK
  183.  
  184. The marked block is saved on disk.
  185.  
  186. 7) PRINT BLOCK
  187.  
  188. The print-out takes place as described above -> PRINT.
  189.  
  190.  
  191.                                   IV) PREFS
  192.  
  193. 1) LENGTH OF PAGE
  194.  
  195. The new page-length is set which must range from 10 to 72 lines.
  196.  
  197. 2) WIDTH OF TEXT
  198.  
  199. The  width  must  range  from  10 to 255. If a block has been marked, it will
  200. formatted according to the new width.
  201.  
  202. 3) INSERT ON/OFF
  203.  
  204. The  insert-mode  is  either switched on or off. If switched on the 3 letters
  205. 'INS' above the ruler indicate it, and characters are inserted in the already
  206. existing text and don't overwrite the text.
  207.  
  208. 4) LETTER ON/OFF
  209.  
  210. The  letter-mode  is  either  switched  on  or  is  displayed above the ruler
  211. (LETTER/ASCII). Every time when a file is loaded  or  saved  the  letter-mode
  212. determines  whether  an  ASCII-file  or  a file in letter-format is loaded or
  213. saved. You can identify a file in letter-format by its suffix '.txp'.
  214.  
  215. 5) AUTO-DIV ON/OFF
  216.  
  217. Text  Plus V2.0 was originally designed to be a German word-processor. Due to
  218. the occurrence of ultra-long words in German a function called Auto-Div which
  219. divides ultra-long words in accordance with German grammar has been  provided
  220. in  order  to  decrease  the  number of ultra-long gaps in the text. Auto-Div
  221. divides English words in accordance with German grammar, too. This is why you
  222. better keep it switched off. If there is  someone  who  wants  TP  to  divide
  223. English  words  according  to  English grammar then don't hesitate to send me
  224. first the share and then the rules of English grammar.
  225. If Auto-Div is switched on and if  a  block  is  marked  and  then  formatted
  226. (left/right-  aligned, centered, justification), words which are too long for
  227. the respective line are divided in order to avoid large gaps. Auto-Div is not
  228. perfect. This is why you should always check the division. Words  divided  by
  229. TP  end  with  this  dash '­' and only this dash is accepted by TP in case of
  230. reformatting to indicate a division.
  231.  
  232. 6) GO TO ...
  233.  
  234. After  the  string  which  is  to  be  searched  for  has been entered, TP is
  235. searching for it at the beginning of every line and only finds the string  if
  236. it starts in the first column.
  237. This routine is quite useful for C-programmers, because one can find modules,
  238. e.g. main() , very fast especially in long sourcecodes.
  239.  
  240. Nach  der  Eingabe des zu suchenden Strings, sucht TP am linken Textrand jeder
  241. Zeile nach dem jeweiligen String und findet diesen nur, wenn er sich am linken
  242. Rand befindet. Diese Routine ist beim Programmieren in C recht nützlich,  weil
  243. man  so schnell bestimmte Module in längeren Sourcecodes anspringen kann (z.B.
  244. Gehe zu ... main() { ).
  245.  
  246. 7) GO TO LINE X
  247.  
  248. TP jumps to line x. This routine, too, is  useful  for  programmers,  because
  249. compilers tell the user the line in which an error has occurred.
  250.  
  251.  
  252.                                   V) STYLE
  253.  
  254.  
  255. 1-4) NORMAL, UNDERLINE, BOLD, ITALIC
  256.  
  257. The  new style is set, and if a block has been marked, it is displayed in the
  258. new style.
  259.  
  260. 5-8) LEFT ALIGNED, RIGHT ALIGNED, CENTERED, JUSTIFICATION
  261.  
  262. The  line  in  which  the cursor is located is formatted according to the new
  263. alignment, or if a block has been marked, the block is formatted.
  264.  
  265.  
  266.                                   VI) FIND
  267.  
  268.  
  269. 1-3) FIND, NEXT, PREVIOUS
  270.  
  271. After the search-string has been entered and found it is displayed in the top
  272. line  and  the  cursor is set to the beginning of the word. NEXT and PREVIOUS
  273. search for the next or previous occurrence of the already entered string.
  274.  
  275. 4-6) REPLACE, NEXT, PREVIOUS
  276.  
  277. After  the  search-string  and  the  replace-string have been entered and the
  278. search was successful, the user is asked if he really wants  to  replace  the
  279. found  string.  NEXT  and PREVIOUS search for the next or previous occurrence
  280. of the search-string.
  281.  
  282.  
  283.                           VII) KEYMAP AND SHORTCUTS
  284.  
  285.  
  286. 1) KEYMAP
  287.  
  288. CONTROL
  289.  
  290. -b       mark begin/end of block
  291. -c       insert block at position of cursor
  292. -v       delete mark
  293. -x       delete block
  294.  
  295. -j       delete line
  296. -k       delete rest of line
  297. -l       insert line
  298. -q       save and quit
  299. -t       display length and end of text
  300.  
  301. -n/-u    style: normal/underline
  302. -o/-p    style: bold/italic
  303.  
  304. -e       insert-mode   on/off
  305. -r       letter-mode   on/off
  306. -y       auto-div-mode on/off
  307.  
  308. -a/-s    skip to begin/end of text
  309. -d/-f    skip to begin of next/previous page
  310. -g/-z    go to ... / go to line x
  311.  
  312. SHIFT-CRSR-UP/DOWN   skip to top/bottom of window or 18 lines up/down
  313. SHIFT-CRSR-LFT/RGHT  skip to begin/end of line
  314.  
  315. HELP     show keymap
  316. ESC      quit without saving changes
  317.  
  318. 2) SHORTCUTS
  319.  
  320. RIGHT AMIGA
  321.  
  322. -g       load file
  323. -a       append file
  324. -d       delete file in memory
  325. -o       save
  326. -s       save as ...
  327. -q       save and quit
  328. -p       print
  329.  
  330. -k       load block
  331. -m       save block
  332. -z       print block
  333.  
  334. -t       page-length
  335. -w       text-width
  336.  
  337. -n       style:  normal
  338. -u               underline
  339. -b               bold
  340. -i               italics
  341. -l       alignment: left
  342. -r                  right
  343. -c                  centered
  344. -j                  justification
  345.  
  346. -f       find
  347. -1        ""  next
  348. -2        ""  previous
  349. -e       replace
  350. -3        ""  next
  351. -4        ""  previous
  352.  
  353.  
  354. IS THIS THE END OF THE DOC-FILE! OH, YES!
  355.  
  356. Keep on using Text Plus V2.0, bye bye and tschuess
  357.  
  358.  
  359. 11.04.1990                       Martin
  360.